home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / cshw824b.zip / CSHOW8A.DOC < prev    next >
Text File  |  1991-05-07  |  45KB  |  1,063 lines
  1.                                =================
  2.                                C o m p u S h o w
  3.                                =================
  4.  
  5.  
  6.  
  7.                             Standard Version 8.24a
  8.  
  9.                                     for the
  10.                  IBM PC, XT, AT, PCjr, PS/2 (and compatibles)
  11.                                      with
  12.  
  13.                      Hercules Monochrome Graphics Adapter
  14.                                       or
  15.                          Color Graphics Adapter (CGA)
  16.                                       or
  17.                         Enhanced Graphics Adapter (EGA)
  18.                                       or
  19.                        Multi-Color Graphics Array (MCGA)
  20.                                       or
  21.                           Video Graphics Array (VGA)
  22.  
  23.  
  24.  
  25. Installing CompuShow
  26. ====================
  27.  
  28.  The CompuShow program(s) have been compressed using PkLite. Do not attempt to
  29.  compress them again using PkLite, LzExe or a similar utility. If you received
  30.  CompuShow on  a  floppy disk,  install  it as  described  below and  set  the
  31.  original floppy aside (don't run ANY  SOFTWARE on an original "master  disk";
  32.  install it on a  hard disk or a  "working copy floppy  disk", first.) If  you
  33.  downloaded CompuShow using  a modem,  copy the  downloaded file  to a  backup
  34.  floppy before proceeding.
  35.  
  36.  Installing on a floppy disk
  37.  ---------------------------
  38.  
  39.  Install CompuShow  on a  floppy disk  by  copying the  CompuShow files  to  a
  40.  formatted disk. For example, "COPY A:*.* B:" will copy all files from a  disk
  41.  in drive A: to  a disk in  drive B:. Once you've  started CompuShow, you  can
  42.  remove the program  disk in order  to mount other  disks containing  graphics
  43.  (and press Alt-A  or Alt-B to  display the file  directory of a  new disk  in
  44.  drive A: or B:).
  45.  
  46.  Installing on a hard disk
  47.  -------------------------
  48.  
  49.  Install CompuShow on a hard disk by placing the files in a separate hard disk
  50.  sub-directory. For example, to place CompuShow on hard disk drive C:
  51.  
  52.         C:
  53.         MD CSHOW
  54.         CD CSHOW
  55.         COPY A:*.*
  56.  
  57.  
  58.  
  59.                                                                         Page 1
  60.  In order to be  able to execute CompuShow  "from anywhere" (even when  you're
  61.  not logged to the  CSHOW sub-directory on  drive C:), you can  do one of  two
  62.  things:
  63.  
  64.   1) add "C:\CSHOW" to the "PATH" statement in AUTOEXEC.BAT
  65.   2) use a batch file (on the path) to execute CompuShow.
  66.  
  67.  We recommend the  second method, so  create a batch  file in a  sub-directory
  68.  that's already included in the  path statement of AUTOEXEC.BAT. For  example,
  69.  at your DOS prompt, execute the  PATH command without any parameters to  find
  70.  out what the current setting is:
  71.  
  72.         PATH                                    <-- you type this
  73.         PATH=C:\PROGRAMS;C:\BATS;C:\DOS         <-- DOS responds
  74.  
  75.  (If the PATH command  indicates that you  don't have a  PATH set, you  really
  76.  should check your DOS manual to read  about the advantages of setting a  path
  77.  in AUTOEXEC.BAT). Select an appropriate  sub-directory (such as C:\BATS)  and
  78.  create a batch file to execute CompuShow:
  79.  
  80.  (DOS version 3 and above):
  81.  
  82.         C:
  83.         CD \BATS
  84.         COPY CON CSHOW.BAT
  85.         C:\CSHOW\CSHOW %1 %2 %3 %4 %5 %6 %7 %8 %9^Z
  86.  
  87.  (DOS below version 3):
  88.  
  89.         C:
  90.         CD \BATS
  91.         COPY CON CSHOW.BAT
  92.         C:
  93.         CD \CSHOW
  94.         CSHOW %1 %2 %3 %4 %5 %6 %7 %8 %9^Z
  95.  
  96.  (The ^Z above means hold down the CTRL  key and type Z). The purpose of  "%1"
  97.  through "%9" is to  allow you to pass  command-line arguments to the  program
  98.  through the batch file. Execute "CSHOW" at your DOS prompt and the batch file
  99.  is executed to load CompuShow no matter "where you are".
  100.  
  101.  CompuShow requires  at  least 221k  of  available memory  (depending  on  the
  102.  "start-up options"  specified.)  If  the program  displays  an  "Insufficient
  103.  memory" message, you need to make more memory available. (Remove some memory-
  104.  resident programs, for example.)
  105.  
  106. Start-Up Options
  107. ================
  108.  
  109.  "Command-line switches" let you control  graphics video features and the  way
  110.  that the program allocates memory for various purposes.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                                                         Page 2
  119. Video Hardware Identification
  120. -----------------------------
  121.  
  122.  CompuShow should recognize the type of video adapter present in your computer
  123.  (Hercules, CGA,  EGA, MCGA,  or VGA).  In case  the detect  routine fails  to
  124.  identify the  correct  adapter,  a  command-line  switch  will  override  the
  125.  automatic routine:
  126.  
  127.      >CShow +H          (or +h)       force Hercules mode
  128.      >CShow +C          (or +c)       force CGA mode
  129.      >CShow +E          (or +e)       force EGA mode
  130.      >CShow +B          (or +b)       force EGA (monochrome monitor) mode
  131.      >CShow +M          (or +m)       force MCGA mode
  132.      >CShow +V          (or +v)       force VGA mode
  133.  
  134. "Super-Ega"
  135. -----------
  136.  
  137.  A "/" switch is  used to  indicate the  presence of  a 480  line  "Super-EGA"
  138.  adapter. The program knows about several:
  139.  
  140.      >CShow /A          ( or /a )     Ahead Systems
  141.      >CShow /G          ( or /g )     Genoa
  142.      >CShow /P          ( or /p )     Paradise AutoSwitch EGA-480
  143.      >CShow /T          ( or /t )     Tseng
  144.      >CShow /V          ( or /v )     "VGA" (eg. the Zenith "VGA")
  145.  
  146.  These commands specify graphics modes 38,  115, 80, 37, and 18  respectively,
  147.  which puts  each card  in 480  line EGA  mode. Other  480 line  cards may  be
  148.  identified by supplying the (decimal) graphics mode number, for example:
  149.  
  150.      >CShow /71                       to use mode 71 for 640x480 EGA
  151.  
  152. Hardware-Specific Video Drivers:
  153. --------------------------------
  154.  
  155.  CompuShow uses "video drivers" to support  extended graphics modes on a  wide
  156.  variety of video hardware.   With the standard  (version 8.24a) program,  the
  157.  video drivers  are  included as  separate  disk files,  named  "videoP1.drv",
  158.  "videoI4.drv", etc. The "+S" command-line switch tells the program to load  a
  159.  specific video driver, for example:
  160.  
  161.                 >CShow +sP1
  162.  
  163.  loads the "P1" video driver ("videoP1.drv").
  164.  
  165.  To set up a video driver to  be loaded automatically whenever the program  is
  166.  started:
  167.  
  168.                 >copy videoP1.drv video.drv
  169.  
  170.  With no "+S" switch specified, the program will load file "VIDEO.DRV".
  171.  
  172.  NOTE: See the "Video Driver Modes" section of this document, which  describes
  173.  how you can tell CompuShow which modes work with your video card and monitor.
  174.  Once you set up  VIDEO.DAT, CompuShow will consider  video driver modes  when
  175.  selecting the "best mode" for display with the spacebar.
  176.  
  177.                                                                         Page 3
  178.  With the enhanced (version  8.24b) program, the  video (and printer)  drivers
  179.  are "built in to" and selected with the System Configuration program  CSHOWI.
  180.  When you select a video driver with the CSHOWI program, it creates  VIDEO.DAT
  181.  and VIDEO.DRV, which are loaded automatically at program start-up.
  182.  
  183.  +-------------------------------------------------------------------------+
  184.  | FOR A COMPLETE, UP-TO-DATE LISTING OF THE VIDEO DRIVERS, SEE README.DOC |
  185.  +-------------------------------------------------------------------------+
  186.  
  187. Optional Features
  188. -----------------
  189.  
  190.  A "#" switch is used to specify optional features:
  191.  
  192.      >CShow #E          ( or #e )     DISABLES horizontal EGA panning
  193.  
  194.  Some EGA adapters have trouble with  horizontal panning. If your EGA  display
  195.  is "scrambled", use the #E switch.
  196.  
  197.      >CShow #J          ( or #j )     ENABLES PCjr/Tandy-1000 video modes
  198.  
  199.  The program  will reserve  32k of  memory required  for these  special  video
  200.  modes. (Without this switch, the memory  is available for the program to  use
  201.  for other purposes.)
  202.  
  203.      >CShow #MS         ( or #ms )    allocate MEMORY for a SMALL buffer
  204.      >CShow #MM         ( or #mm )    allocate MEMORY for a MEDIUM buffer
  205.      >CShow #ML         ( or #ml )    allocate MEMORY for a LARGE buffer
  206.  
  207.  This option lets you control the  amount of memory that the program  reserves
  208.  for reading the graphics file. The small  buffer is 2k, the medium buffer  is
  209.  32k, and the large buffer  is 62k. A small (2k)  buffer is the default.  (The
  210.  size of the read  buffer DOES NOT  determine the maximum  size file that  the
  211.  program can display: a 45k file requires  23 reads with a 2k buffer, 2  reads
  212.  with a 32k buffer, and 1 read with a 62k buffer.)
  213.  
  214.      >CShow #D300
  215.  
  216.  This option  lets you  control the  amount of  memory reserved  for the  file
  217.  directory. The "default" is 120 files. You  may specify any number from 0  to
  218.  9999.
  219.  
  220.      >CShow #Q
  221.  
  222.  Turns off the sounds that the program makes (Quiet).
  223.  
  224.      >CShow #B
  225.  
  226.  If you have a  laptop or any computer  with an LCD  screen, this option  will
  227.  provide "readable colors" (gray and black).
  228.  
  229.      >CShow #L
  230.  
  231.  This one's  for Leading  Edge "IBM  compatible" computers.  If the  CompuShow
  232.  screen goes blank on your Leading Edge, use "#L".
  233.  
  234.  
  235.  
  236.                                                                         Page 4
  237. Missing files
  238. -------------
  239.  
  240.  The CompuShow  "package" includes  the  program, documentation  files,  video
  241.  drivers, etc. When CompuShow starts, it checks to see that all its files  are
  242.  present and displays  a "missing  files" message for  15 seconds  if any  are
  243.  missing. If you have  a copy of  the original disk  or archive including  all
  244.  these files, you don't  need to keep  them on your  "working floppy" or  hard
  245.  disk:
  246.  
  247.   - Install  CompuShow  to  a  "working   copy  floppy  disk"  or  hard   disk
  248.     sub-directory, as described  above. (Remember  to set  aside the  original
  249.     "master disk" or backup copy of your download.)
  250.  
  251.   - Execute CSHOW. With all files present, it will create CSHOW.DAT
  252.  
  253.   - Execute CSHOWDEL  to  delete  the documentation  and  video  drivers  (and
  254.     CSHOWDEL.BAT, so a "batch file missing" message is normal.)
  255.  
  256.  Please remember that you MUST INCLUDE ALL FILES when you pass CompuShow on to
  257.  a friend, or post it on a BBS.
  258.  
  259. Dual Monitor Operation
  260. ======================
  261.  
  262.  On a system with both a monochrome  and color graphics (CGA, EGA, VGA,  etc.)
  263.  adapter installed, start the program on the monochrome monitor to operate  in
  264.  dual monitor  mode.  The  directory  screen will  appear  on  the  monochrome
  265.  monitor, and graphics images on the color graphics monitor.
  266.  
  267.  When you finish displaying  a graphic, press <Carriage  Return> to leave  the
  268.  graphic image on screen, or <ESCape> to clear the graphics screen.
  269.  
  270. [F1] for Help
  271. =============
  272.  
  273.  Press the [F1] function key  to pop up a  quick-reference Help Screen with  a
  274.  brief description of the options available.
  275.  
  276. [Shift-F1] for Information
  277. ==========================
  278.  
  279.  Hold a  shift key  and  press the  [F1]  function key  to  pop up  a  Program
  280.  Information box, which identifies the options you've specified and the amount
  281.  of memory used by the program  for various purposes. Several of the  start-up
  282.  options control the way the program  allocates memory. This is important  for
  283.  several reasons.
  284.  
  285.   - The amount of Display  Memory determines the  extents for panning  images,
  286.     and can affect  the operation  of transparency and  "restore to  previous"
  287.     functions.
  288.  
  289.     The (default)  small read  buffer provides  the most  memory for  a  large
  290.     virtual screen. If you specify a larger read buffer (eg. with the "#MM" or
  291.     "#ML" command line switch), you take memory away from the virtual screen.
  292.  
  293.  
  294.  
  295.                                                                         Page 5
  296.   - If you have a lot of files in the directory, and the program needs  memory
  297.     to pop up a box, it will have to "abandon" the sorted file list. When  you
  298.     return to the directory screen, the  program will retrieve, sort, and  re-
  299.     display the directory, and  you will be  placed at the  first file on  the
  300.     first screen.
  301.  
  302.     The "#D" option  lets you reserve  memory for  a directory of  up to  9999
  303.     files, so that the  program won't have  to "abandon" it  to pop up  boxes.
  304.     Keep in  mind that  reserving memory  for a  large directory  leaves  less
  305.     memory for the virtual screen.
  306.  
  307. Changing the directory display
  308. ==============================
  309.  
  310.  The program  automatically selects  a  format to  display  as many  files  as
  311.  possible on each screen.  If you have  more than one  screen of files,  press
  312.  PgDn/PgUp to view the next/previous directory screen.
  313.  
  314.  - At the input area, you may change to  a different disk drive by typing  the
  315.    drive designation and  pressing the [F2]  key. For example,  type "A:"  and
  316.    press [F2] to switch to drive A:.
  317.  
  318.    You may also change  to a different  sub-directory. Type the  sub-directory
  319.    name in the input area and press [F2]. The sub-directory specification  can
  320.    be  any  form  acceptable  in  a  DOS  "ChDir"  command,  such  as  "\"  or
  321.    "..\..\OTHER". You can also combine a drive and sub-directory change,  such
  322.    as "B:\PICS".
  323.  
  324.      Press [Shift-F2] to change to your "original" (drive and)  sub-directory;
  325.      where you were when you started CompuShow.
  326.  
  327.      Press [Ctrl-F2] to change to the (drive and) sub-directory containing the
  328.      CompuShow program.
  329.  
  330.      Press [Alt-F2] to change to the "start-up" (drive and) sub-directory that
  331.      you installed with CShowI (with the enhanced program.)
  332.  
  333.      Press [Alt-A] or [Alt-B] to change to drive A: or B:.
  334.  
  335.  - Press [F3] to  "toggle" between the  compressed directory display  (4 or  6
  336.    columns) and a wide  directory display (two  columns, including file  name,
  337.    size, date, and time.)
  338.  
  339.  - Enter a directory mask and press [F4]. Type "*.GIF" and press [F4] to limit
  340.    the directory display to all files with a ".GIF" file name extension. Press
  341.    [F4] with a blank mask to reset the directory mask to "*.*".
  342.  
  343.  - Press [F5] to pop up a directory sort box:
  344.  
  345.     - Press "C" for a Complete directory display with the volume label, hidden
  346.       files and sub-directories, including  "." (this sub-directory) and  ".."
  347.       (the directory "above"). Press "O" to display Only files.
  348.  
  349.     - Press "U", "N", "E", "S", or "D" for Unsorted (DOS sequence) or to  sort
  350.       the directory on Name, Extension, Size, or Date.
  351.  
  352.  
  353.  
  354.                                                                         Page 6
  355.     - Press "F"  or  "B"  for Forward  (ascending)  or  Backward  (descending)
  356.       sequence.
  357.  
  358.     - Press carriage return when you're done.
  359.  
  360. Selecting a file to display
  361. ===========================
  362.  
  363. Method 1: Enter the name of the file
  364. ------------------------------------
  365.  
  366.  Type the name of any file and press <Carriage Return> to select it. Note that
  367.  you may use this method  to specify a file that's  not in the displayed  file
  368.  list.  (You  may  need  to  include   the  drive  and  subdirectory,  as   in
  369.  "c:\pics\special\hidden\other.gif"). When  you press  <Carriage Return>,  the
  370.  file will be retrieved, or a "beep" will sound if it was not found.
  371.  
  372. Method 2: Selecting from the directory list
  373. -------------------------------------------
  374.  
  375.  Press the "up arrow" cursor key to move into the directory display, then:
  376.  
  377.   - "Down arrow" ("Up arrow") moves you to the next (previous) file.
  378.  
  379.       - At the  last  (first)  file  on  the screen,  you  move  to  the  next
  380.         (previous) screen, if there is one.
  381.  
  382.   - Ctrl-PgDn (Ctrl-PgUp) moves you to the bottom (top) of the column.
  383.  
  384.   - Ctrl-End (Ctrl-Home) moves you to the last (first) file on the screen.
  385.  
  386.   - PgDn (PgUp) moves you to the next (previous) screen.
  387.  
  388.   - End (Home) moves you immediately to the last (first) file.
  389.  
  390.   - A letter key (A..Z) moves you to the next file starting with that  letter.
  391.     (Type "A" repeatedly to move to each file starting with "A".)
  392.  
  393.  When you find  a graphic  that you  want to  display, press  the SpaceBar  to
  394.  display  it  immediately,  or  <Carriage  Return>  to  pop  up  the  Graphics
  395.  Information Box.
  396.  
  397.  Press ESCape to return the cursor to the input area.
  398.  
  399. Directory "Goodies"
  400. ===================
  401.  
  402.   ChDir At a sub-directory (identified by  <DIR>), press <Carriage Return>  to
  403.         change to that sub-directory.  Sub-directories are displayed when  you
  404.         select "C"omplete in the [F5] directory sort box. Remember that "." is
  405.         "this directory" (so  nothing happens  when you attempt  to change  to
  406.         "."), and ".." is "the directory above".
  407.  
  408.   DEL   Press Alt-D to delete the current file. (You must confirm a delete  by
  409.         responding "Y".)
  410.  
  411.  
  412.  
  413.                                                                         Page 7
  414.   REN   Press Alt-R to REName the current file. Enter a new name for the file,
  415.         or press ESCape (or just leave  it blank and press <carriage  return>)
  416.         to change your mind about renaming it.
  417.  
  418.   COPY  Press Alt-C to  copy the  current file. Enter  the "destination"  file
  419.         name, or press  ESCape (or  just leave  it blank  and press  <carriage
  420.         return>) to change your mind about copying it.
  421.  
  422.  NOTE: While parallel to the  DOS commands "REN"  and "COPY", these  functions
  423.  are different in one important respect. You can't use any "short-cuts",  such
  424.  as "?" or "*" wildcards for Alt-R and Alt-C, or "destination only" for Alt-C:
  425.  
  426.  Valid DOS command              CShow function
  427.  ----------------------         -------------------------
  428.  REN  NUMBER1.GIF  N1.*         Alt-R (name>) N1.GIF        (N1.* won't work)
  429.  COPY NUMBER1.GIF  N1.*         Alt-C (name>) N1.GIF        (N1.* won't work)
  430.  COPY NUMBER2.GIF  B:           Alt-C (name>) B:NUMBER2.GIF (B: won't work)
  431.  
  432. The Graphics Information Box
  433. ============================
  434.  
  435.  When you press the SpaceBar while in the file directory area, the graphic  is
  436.  displayed immediately in the  best available display  mode. If, instead,  you
  437.  press <Carriage Return>, the Graphics Information Box pops up.
  438.  
  439.  The top line of the  box identifies the type of  graphic file, and any  other
  440.  information available, such as "version", width, height, and number of colors
  441.  in the graphic.
  442.  
  443.  Monochrome graphics  (CompuServe RLE  and MacPaint)  have a  simple  Graphics
  444.  Information Box, with a single display option. To display the graphic,  press
  445.  "1" or the spacebar.
  446.  
  447.  Color graphics (CompuServe GIF, PC  Paint, PC Paintbrush, Dr. Halo,  ColoRix,
  448.  etc.) have up to 40 display modes listed; for example "EGA 5=320x200x16":
  449.  
  450.    - You may have Hercules,  CGA, PCjr/Tandy, EGA,  MCGA, VGA, "extended  VGA"
  451.      and video driver  modes available, based  on the type  of video  adapter,
  452.      start-up options, and the video driver you've loaded.
  453.  
  454.    - The "5" will appear in a bright text color if it's "recommended" or in  a
  455.      dim color if the graphic is larger than the screen, or has more colors.
  456.  
  457.    - The "=" indicates that this is a  "true" graphic mode. A ":" indicates  a
  458.      simulated mode.
  459.  
  460.    - "320x200x16" means that  the screen is  320 "pixels" (dots)  wide by  200
  461.      pixels high in 16 colors.
  462.  
  463.  To display a  color graphic, press  the key  ("5" in the  above example),  or
  464.  press the spacebar to have the program choose the "best available mode".
  465.  
  466. RLE Graphics
  467. ============
  468.  
  469.  The RLE format  supports "Medium"  (128x96) and  "High" (256x192)  resolution
  470.  monochrome graphics. While the RLE image is displayed:
  471.  
  472.                                                                         Page 8
  473.        - Press  "N"  (or  Alt-N)  to   Negate  the  image.  Some  RLE   images
  474.          (radar/weather maps, for example) should be "negated", which reverses
  475.          black and white, before printing. Without negating, you would print a
  476.          black page with white lines.
  477.  
  478.        - With the enhanced program,  you may print the  image by pressing  "P"
  479.          (or ^P).
  480.  
  481. MacPaint Images
  482. ===============
  483.  
  484.  The information box indicates the number of rows in the MacPaint image.  Each
  485.  image is 576 wide,  and a maximum  of 720 long.  MacPaint images are  usually
  486.  longer than the physical screen. During display:
  487.  
  488.        - The up and down arrow keys "auto-pan", so that the image moves slowly
  489.          up or down the screen until the top or bottom is reached, or until  a
  490.          key is pressed to stop the "auto-pan."
  491.  
  492.        - Home and End jump immediately to the top and bottom.
  493.  
  494.        - Press "N" (or Alt-N) to negate the image.
  495.  
  496.        - On an EGA  or VGA,  press "C" during  the display  to "colorize"  the
  497.          image. The 576x720 image is compressed to 288x360, and displayed with
  498.          shades of reds and browns in place of the black and white image.  The
  499.          [F1]..[F10] function keys allow  you to select  any of ten  different
  500.          pre-defined color palettes.
  501.  
  502.          Press any key to remove the colorized image.
  503.  
  504.        - With the  enhanced  program  you  may print  the  MacPaint  image  by
  505.          pressing "P" (or ^P).
  506.  
  507. CompuServe GIF Graphics
  508. =======================
  509.  
  510.  The information box for a GIF (pronounced "JIF") graphics file indicates  the
  511.  GIF signature and version. CompuShow  supports GIF versions "87a" and  "89a".
  512.  If the GIF  file is an  unknown (future)  version, you will  hear a  "buzzer"
  513.  sound, and  the GIF  version will  blink. The  width, height,  and number  of
  514.  colors in the image are also shown.
  515.  
  516.  During display, if there's an error in the GIF file, the program will make  a
  517.  "buzzer" sound  as the  error is  encountered.  When you  return to  the  GIF
  518.  information box, the  error description  and location  are shown  on the  top
  519.  line:
  520.  
  521.       Version: GIF87a, 320x200x256    Error: End Of File at 36050 [00]
  522.  
  523.  The possible errors are: Bad  Block ID, Bad MinCode,  End of File, Bad  Code,
  524.  Invalid Image, Interlace Overrun,  and Sequential Overrun.  In all cases,  an
  525.  error indicates that the GIF file is damaged (perhaps in downloading), or was
  526.  incorrectly encoded in the first place.
  527.  
  528.  With the release of GIF version 89a (July '90) several exciting new  features
  529.  are supported:
  530.  
  531.                                                                         Page 9
  532.   - Text may  be included  for display  with the  graphic. On  an EGA  or  VGA
  533.     system, CompuShow uses a text font "built-in" to the adapter. On any other
  534.     adapter, the program uses the character fonts in the file FONTS.DRV.
  535.  
  536.   - A "user input" request  causes CompuShow to  wait for you  to press a  key
  537.     before continuing, to allow you time  to read text, etc. To indicate  that
  538.     it's waiting for your  keypress, the program sounds  a "click". Press  any
  539.     key to proceed (ESCape will interrupt further processing.)
  540.  
  541.   - Delays between images may be used for  animation or to allow time for  you
  542.     to read text. Delays are also  usually associated with any user input,  so
  543.     that the program can continue after you've pressed a key or the delay time
  544.     has expired.
  545.  
  546.   - Transparency may  be  used  to  create  non-rectangular  images  (or  text
  547.     characters) to appear "on top of" the underlying image.
  548.  
  549.   - Images may  appear which  are "disposed  of" by  restoring to  either  the
  550.     background color or the previous (underlying) image.
  551.  
  552.   - Comments may be  included by  the person  creating the  GIF. After  you've
  553.     viewed a GIF with comments, you're asked whether you want to read them.
  554.  
  555.  As a  rule of  thumb, transparency  and restore  to previous  functions in  a
  556.  640x480x256 GIF will  require a 640k  system, with no  RAM resident  programs
  557.  loaded (TSRs, RAM disks, etc.), so that at least 530k of memory is  available
  558.  to CompuShow. If there isn't  enough memory available, the transparent  color
  559.  will be displayed, and restore  to previous will be  handled as a restore  to
  560.  background.
  561.  
  562.   +-------------------------------------------------------------------------+
  563.   | See  README.DOC for information about "CompuMake Tools"  for converting |
  564.   | your  existing  graphics  images  to GIF,  including  support  for  all |
  565.   | features of the GIF89a format.                                          |
  566.   +-------------------------------------------------------------------------+
  567.  
  568. PC Paintbrush
  569. =============
  570.  
  571.  The information box for a PC Paintbrush PCX file indicates the version,  size
  572.  and number  of colors.  CompuShow  supports PC  Paintbrush version  2.5,  2.8
  573.  (including external  256 color  palette  ".PAL" file),  and 3.0  graphics  in
  574.  2 to 256 colors.
  575.  
  576. PC Paint
  577. ========
  578.  
  579.  The information box for a  PC Paint PIC file  indicates the size, colors  and
  580.  "mode". CompuShow displays mode "G" and "L" graphics with 16 or 256 colors.
  581.  
  582.  Note that PC Paint graphics are displayed  starting at the bottom, so if  the
  583.  graphic is larger than  the screen, it may  appear that nothing is  happening
  584.  until you reach the point where the row is on screen.
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                                                        Page 10
  591. Dr. Halo
  592. ========
  593.  
  594.  The information box for a Dr. Halo  PIC file indicates the version, size  and
  595.  number of colors. CompuShow supports Dr. Halo versions 2 and 3, and a  number
  596.  of  formats  including  320x200x4,  320x200x16,  640x350x16,  720x348x2   and
  597.  720x348x16.
  598.  
  599. RIX ColoRix and Ega Paint
  600. =========================
  601.  
  602.  The information box for a ColoRix "SCx" file indicates the size and number of
  603.  colors. CompuShow  supports uncompressed  ColoRix files  in a  wide range  of
  604.  sizes and 256 colors.
  605.  
  606.  Ega Paint images are 640x350x16 colors.
  607.  
  608. Targa
  609. =====
  610.  
  611.  Targa 16, 24, or  32 bit, uncompressed or  run-length-encoded, mapped or  RGB
  612.  images may be displayed. (Targa type 1, 2, 9, and 10.)
  613.  
  614. Deluxe Paint
  615. ============
  616.  
  617.  Deluxe Paint II and Deluxe Paint II Enhanced "LBM" (and "BBM", etc.)
  618.  
  619. Color Graphic Display
  620. =====================
  621.  
  622.  To display any color graphic (GIF, PC Paintbrush, PC Paint, Targa, etc.):
  623.  
  624.  - Type any character listed in the Information Box to display the graphic  in
  625.    that mode, or
  626.  
  627.  - Press the  spacebar  to  have  the program  select  the  "best  mode"  (the
  628.    character it will use is  displayed at the cursor),  based on the size  and
  629.    number of colors  in the  graphic. To tell  the program  to consider  video
  630.    driver modes  when  selecting the  best  display mode,  see  "Video  driver
  631.    modes", below.
  632.  
  633.      As the image is being displayed, press ESCape or Ctrl-C to interrupt (and
  634.      abort) display of the rest of  the image. (The partial image will  remain
  635.      on the screen. Type <Carriage Return> to return to the information box.)
  636.  
  637.      While the image is displayed:
  638.  
  639.        - Images larger than the PHYSICAL SCREEN can be "panned", using the up,
  640.          down, left and right cursor arrow keys. Press a key (once) to pan  in
  641.          that direction. Panning will stop at the end of the image, or may  be
  642.          interrupted by pressing any key. In addition:
  643.  
  644.              Home/End jump to the upper-left/lower-right corner,
  645.              Ctrl-Lft/Ctrl-Rgt jump "one screen width" Left/Right,
  646.              Ctrl-Home/Ctrl-End jump "one screen height" Up/Down.
  647.  
  648.  
  649.                                                                        Page 11
  650.           - The EGA/VGA display pans both vertically and horizontally, and can
  651.             accommodate 16 color images up to 320x1638, 640x819, or 1024x512.
  652.  
  653.           - Other display modes (including  hardware-specific modes) pan  both
  654.             vertically and horizontally, with the maximum size dependent  upon
  655.             the amount of  memory available. (The  [Shift-F1] information  box
  656.             indicates the size of the "virtual screen".)
  657.  
  658.        - The "brightness"  of  any  monochrome  (mode  A..P)  display  may  be
  659.          adjusted, as described below.
  660.  
  661.        - Alt-N negates any monochrome display.
  662.  
  663.        - Alt-R "rotates" the color palette on an MCGA or VGA adapter.
  664.  
  665.        - On an  EGA/MCGA/VGA monitor,  you may  adjust the  appearance of  the
  666.          COLOR image, as described below.
  667.  
  668.        - With the enhanced  program, you may  print an image  by pressing  "P"
  669.          (or ^P).
  670.  
  671. Special Modes:
  672. -------------
  673.  
  674.  On an EGA or  VGA, with a graphic  that's 320x200 or smaller,  a "Z" mode  is
  675.  available:
  676.  
  677.    - If the graphic has  16 colors or less,  this will display it  double-wide
  678.      and double-high using the 640x350x16 or 640x480x16 mode, which will  have
  679.      much truer colors than the 320x200x16 display.
  680.  
  681.    - If it  has more  that 16  colors, it  will be  displayed using  a  "color
  682.      dithering" routine, which simulates over 2000 colors.
  683.  
  684.  On an MCGA or VGA, five "extended" modes are available. These modes work on a
  685.  PS/2 or register compatible VGA, although they aren't "IBM standard" modes.
  686.  
  687.    "[" sets the adapter to 360x480x256 mode.
  688.  
  689.          "]" simulates 720x480x256 by skipping every other pixel horizontally.
  690.  
  691.    "," sets the adapter to 320x400x256 mode.
  692.  
  693.          "." simulates 640x400x256 by skipping every other pixel horizontally.
  694.  
  695.          "/" simulates 640x480x256 by skipping every other pixel horizontally,
  696.              and skipping one row out of every six.
  697.  
  698.  The simulated modes above and the  simulated modes in the video drivers  will
  699.  provide a  good looking  display  on most  graphics,  except for  areas  that
  700.  contain text. Text characters on graphics  screens may be illegible in  these
  701.  simulated modes, since some columns and rows are skipped.
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.                                                                        Page 12
  709. Video driver modes
  710. ------------------
  711.  
  712.  With a  video  driver  loaded,  up  to  seven  additional  modes  (S..Y)  are
  713.  available. The  video  driver lets  you  display graphics  using  the  unique
  714.  capabilities of your video card. Keep in  mind that some of the video  driver
  715.  modes may not  work on  your adapter. For  example, a  (true, not  simulated)
  716.  640x480x256-color  display  requires   512k  of  video   RAM.  Similarly,   a
  717.  1024x768x256 display requires 1meg of video RAM.
  718.  
  719.  NOTE: If you press a  key (S..Y) and the screen  stays in text mode  (perhaps
  720.  changing colors), then that mode isn't supported on your adapter. If the same
  721.  thing happens on ALL the video driver  modes, then you either have the  wrong
  722.  video driver  loaded,  or your  adapter  just doesn't  have  any  "Super-VGA"
  723.  capabilities. (VGA adapters that  are built-in to a  system board or  bundled
  724.  with a  computer  are  often "low-end"  [cheap]  adapters  without  Super-VGA
  725.  capabilities.)
  726.  
  727.  CompuShow doesn't consider video driver modes when selecting the best mode to
  728.  display a graphic with the space bar,  unless you tell it which video  driver
  729.  modes work on your  adapter and monitor.  (The System Configuration  Program,
  730.  CSHOWI, which  comes with  the enhanced  program, automatically  sets up  the
  731.  VIDEO.DAT file described, below.)
  732.  
  733.  For example, assume that modes S, T, U, V, W and X work on your VGA, but your
  734.  monitor can't quite handle mode X.  Also, mode U is a simulated  640x480x256,
  735.  where mode V is the preferred  (true) 640x480x256 mode. To tell CompuShow  to
  736.  use modes S,  T, V, and  W, create a  text (ASCII) file  with the  characters
  737.  "STVW". The name  of the  file corresponds to  the video  driver that  you're
  738.  using: VIDEO.DAT for VIDEO.DRV, or VIDEOP1.DAT for VIDEOP1.DRV (if you  start
  739.  the program using "CSHOW +SP1"). At your DOS prompt:
  740.  
  741.         COPY CON VIDEO.DAT
  742.         STVW^Z
  743.  
  744.  (^Z means hold down the CTRL key and type Z.)
  745.  
  746. Adjusting a MONOCHROME image
  747. ----------------------------
  748.  
  749.  An image displayed in EGA/VGA monochrome  mode P may be adjusted by  pressing
  750.  PgUp to make the image brighter, or  PgDn to make it darker. This  brightness
  751.  adjustment is instantaneous.
  752.  
  753.  An image displayed in a Hercules, CGA, or MCGA monochrome mode (A..O) may  be
  754.  adjusted by pressing  PgUp to make  the image  brighter, or PgDn  to make  it
  755.  darker. You may also adjust the image to a particular brightness by  pressing
  756.  the letter key (A..O). This "adjustment" is accomplished by re-displaying the
  757.  image. The previous image is left on the screen, so you can see the effect of
  758.  the adjustment as the new image  replaces the former display. (Displaying  an
  759.  image in monochrome mode H and then  pressing PgUp results in the same  image
  760.  as monochrome mode G.)
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.                                                                        Page 13
  768. Adjusting a COLOR image
  769. -----------------------
  770.  
  771.  EGA:
  772.  ----
  773.  
  774.  CompuShow uses a "color dithering" technique for displaying images:
  775.  
  776.     - with more than 16 colors,
  777.     - which are 320 wide (or narrower),
  778.     - when displayed in mode Z ("Zoomed" to 640 wide).
  779.  
  780.  With this technique,  the program  "simulates" over  2000 colors  using a  16
  781.  color EGA palette.  Dithered images  MAY NOT  be adjusted.  However, you  CAN
  782.  adjust the colors of a non-dithered image displayed in EGA modes 7, 9, or  Z.
  783.  The sixteen colors displayed are  numbered 0 to 9 and  A to F. Color zero  is
  784.  always the background.  To select a  color to adjust,  type the color  number
  785.  (0..9 or A..F). That color  will flash, so that you  can see where it is  and
  786.  decide whether it  should be adjusted.  There are two  methods for  adjusting
  787.  colors:
  788.  
  789.  - A selected  color may  be adjusted  by increasing  or decreasing  the  Red,
  790.    Green, or Blue component:
  791.  
  792.                 RED:            decrease [F1]   [F2] increase
  793.                 GREEN:          decrease [F3]   [F4] increase
  794.                 BLUE:           decrease [F5]   [F6] increase
  795.  
  796.    Each color has a Red, Green, and Blue component with a "weight" of 0..3, so
  797.    pressing [F2] four times will step through all four levels of Red.
  798.      [ 4 (Red) x 4 (Green) x 4 (Blue) = the palette of sixty-four colors. ]
  799.  
  800.  - You may "step through" all sixty-four colors in color number sequence:
  801.  
  802.                 COLOR NUMBER:   decrease [F7]   [F8] increase
  803.  
  804.  The adjusted palette may be saved to disk by pressing Alt-F10 (hold down  the
  805.  Alt key and type the  [F10] function key.) When you  display the GIF file  in
  806.  mode 7, 9,  or Z, the  program automatically uses  this saved palette  (press
  807.  [F9] to see the  original color palette;  [F10] to switch  back to the  saved
  808.  color palette.)
  809.  
  810.  MCGA/VGA:
  811.  ---------
  812.  
  813.  On an MCGA or VGA adapter, you can adjust the colors of an image displayed in
  814.  any 16 color mode  (5, 6, 7, 9,  or Z) or 256  color mode (8), including  any
  815.  "Super-VGA" modes (S..Y).
  816.  
  817.  - PgUp/PgDn increases/decreases the "brightness" of the image.
  818.  
  819.  - The color may be adjusted:
  820.  
  821.                 RED:            decrease [F1]   [F2] increase
  822.                 GREEN:          decrease [F3]   [F4] increase
  823.                 BLUE:           decrease [F5]   [F6] increase
  824.  
  825.  
  826.                                                                        Page 14
  827.  As with an EGA, the  adjusted palette is saved  to disk by pressing  Alt-F10,
  828.  and [F9] and [F10] allow you  to review the differences between the  original
  829.  and the adjusted palette.
  830.  
  831.  MCGA/VGA Grayscale:
  832.  -------------------
  833.  
  834.  On an MCGA or VGA adapter, any image displayed in a 16 or 256 color mode  may
  835.  be instantly converted to a "Grayscale", by pressing Alt-G, and returned to a
  836.  color display by pressing Alt-C. While the grayscale image is displayed, PgUp
  837.  and PgDn adjust the brightness of the image.
  838.  
  839. Quitting CompuShow
  840. ==================
  841.  
  842.  At the input area, press ESCape to exit the program and return to DOS.
  843.  
  844. The Enhanced Program
  845. ====================
  846.  
  847.  The enhanced program (CompuShow version  8.24b) includes all features of  the
  848.  standard program, plus:
  849.  
  850.   - Printing of all graphics images on most dot matrix and laser printers.
  851.  
  852.      See README.DOC for a complete list of supported printers.
  853.  
  854.   - A "slide show" program with script generator, for automated display of all
  855.     graphics in a "stand-alone" or "operator attended" mode.
  856.  
  857.   - A System Configuration program, which  lets you change screen colors,  and
  858.     specify "start-up" options, making the command-line switches  unnecessary.
  859.     You can also automatically log to  a disk drive and/or sub-directory,  and
  860.     set the type of directory display you want, including:
  861.  
  862.      the [F3] "wide" directory display,
  863.      the [F4] directory mask (eg. "*.GIF"),
  864.      the [F5] directory sort options.
  865.  
  866.  The user's guide describing these features is CSHOW8B.DOC, included with  the
  867.  enhanced program.
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.                                                                        Page 15
  886.                                S H A R E W A R E
  887.                                =================
  888.  
  889.    CompuShow is copyrighted software. However, you are encouraged to copy  and
  890.  share it with others according to the following requirements:
  891.  
  892.       CompuShow may be freely copied and  shared with others, so long  as
  893.       no charge is made for the software, and it is unmodified and copied
  894.       in its  entirety,  including  all  program  documentation  and  all
  895.       support files.
  896.  
  897.       CompuShow may be distributed via modem, provided that all files are
  898.       transmitted (archived) together.
  899.  
  900.    Notice that ShareWare  is copyrighted  software. It's  not "Public  Domain"
  901.  software, nor is  it "free"  software. If you  continue to  use this  program
  902.  beyond a reasonable "trial period", not to  exceed 21 days, you must pay  for
  903.  it by registering.
  904.  
  905.  WHY SHAREWARE?
  906.  --------------
  907.  
  908.    A few  years ago,  we advertised  a (much  simpler) program  in a  national
  909.  computer magazine. Our advertising cost was so high that, even with a  retail
  910.  price of  $45, we  never reached  "break-even"! The  ShareWare concept  turns
  911.  CompuShow into  its own  ad! Our  costs are  reduced, and  we can  price  the
  912.  program accordingly.
  913.  
  914.    ShareWare let's you "try it before you buy it"! You can determine whether a
  915.  program works properly and how easy it is to use, before you pay for it.
  916.  
  917.  WHY REGISTER?
  918.  -------------
  919.  
  920.    Since CompuShow is a ShareWare product,  we don't receive a penny when  you
  921.  download it  from a  commercial information  service, such  as CompuServe  or
  922.  GEnie, from a BBS, or receive it on a disk of ShareWare programs.
  923.  
  924.    Since version 1.7 was released in July 1987, we've continued to improve and
  925.  enhance the program, and have released new versions on a regular basis.  Most
  926.  of the enhancements were suggested by  our registered users, and most of  our
  927.  registered users  have upgraded  as  new versions  are announced.  They  like
  928.  CompuShow and  the  improvements  that  their  registration  fees  have  made
  929.  possible!
  930.  
  931.  If you use CompuShow, you must register:
  932.  
  933.    - Your registration fee makes it possible for us to continue to improve the
  934.      program and  to  provide  similar high  quality  software  at  reasonable
  935.      prices.
  936.  
  937.    - For your registration fee you receive the LATEST COMPLETE VERSION of  the
  938.      ENHANCED PROGRAM.
  939.  
  940.    - As a registered user,  you'll be notified as  new versions are  released,
  941.      and may upgrade for a nominal charge.
  942.  
  943.  
  944.                                                                        Page 16
  945.    - Registered users may purchase other CaSSS software at reduced prices.
  946.  
  947.    - IF YOU USE THE PROGRAM FOR COMMERCIAL PURPOSES, YOU MUST REGISTER.
  948.  
  949.  Registering for the Enhanced Program
  950.  ------------------------------------
  951.  
  952.  For your convenience, we've included an order form (OFORM.DOC) with space for
  953.  all the required information. (Complete it by hand or with a word processor.)
  954.  
  955.                            Prices as of January, 1990
  956.                            --------------------------
  957.  
  958.  Basic registration, 5.25" disk............................. $25
  959.  To receive a 3.5" disk, please add......................... $ 1
  960.  For overseas delivery, please add.......................... $ 2
  961.  Arizona residents, please include 7% sales tax.............
  962.  
  963.    - Credit Card: Indicate  Visa or  MasterCard, card  number, and  expiration
  964.      date.
  965.  
  966.    - Check or Money Order:  must be in  U.S. funds, drawn on  a U.S. bank.  (A
  967.      Canadian Postal Money Order in US Dollars is acceptable.)
  968.  
  969.    - Sorry, no CODs or Purchase Orders.
  970.  
  971.    - The $2 for  overseas shipping  IS NOT  REQUIRED for  the continental  US,
  972.      Alaska, Hawaii, US possessions, APOs, FPOs, Canada or Mexico.
  973.  
  974.    Electronic Mail:  CompuServe Mail: [76555,167]
  975.                      (MCI Mail can be routed to CompuServe)
  976.                      Internet (BITNET, ARPANET, CICNet, etc.):
  977.                          76555.167@compuserve.com
  978.                      GE Mail: R.BERRY7
  979.  
  980.    Paper Mail:       Canyon State Systems and Software
  981.                      Post Office Box 86
  982.                      Sedona, AZ. 86336
  983.  
  984.    Voice:            (602) 282-5070
  985.  
  986.  Orders are shipped first class mail, and registration puts you on our mailing
  987.  list for notification when future versions are available. If you're  ordering
  988.  through a  corporation,  college,  or university  purchasing  department,  an
  989.  individual's name would be advisable, so that upgrade notices don't get  lost
  990.  in "receiving department".
  991.  
  992.  Uploading to a Bulletin Board:
  993.  -----------------------------
  994.  
  995.  As mentioned, we encourage you to copy and share CompuShow with others. We do
  996.  ask, however, that you  be considerate when  you upload to a  BBS (or give  a
  997.  copy to a  friend, computer  club, or  user group.)  A number  of users  have
  998.  called asking for help because the CompuShow that they downloaded from a  BBS
  999.  was missing documentation, and/or support files. Be kind to the other guy! If
  1000.  you're going  to upload  to a  BBS, be  sure you  include ALL  FILES in  your
  1001.  
  1002.  
  1003.                                                                        Page 17
  1004.  upload. Not only  is this A  REQUIREMENT for distribution  as ShareWare,  but
  1005.  it's also the only way to be fair to the people who download it!
  1006.  
  1007.  Keep in mind that any  upload that doesn't include  all files will result  in
  1008.  the display of the "missing files" message.
  1009.  
  1010.  BBS SysOps and ShareWare Distributors:
  1011.  -------------------------------------
  1012.  
  1013.  We appreciate the distribution of CompuShow on electronic bulletin boards and
  1014.  ShareWare disks. If  you have a  version of CompuShow  which may be  outdated
  1015.  (the program date is displayed on the second line of the screen), or you just
  1016.  want to be sure you  have the latest version, contact  me. I'll send you  the
  1017.  most current  version (at  no  charge), and  put you  on  a mailing  list  to
  1018.  automatically receive free upgrades when available.
  1019.  
  1020.  If you see the  "missing files" message at  program start-up, you don't  have
  1021.  the full package and  don't have permission to  distribute it. If the  person
  1022.  who provided the disk or archive  can't supply the missing files, contact  me
  1023.  for the latest complete version.
  1024.  
  1025.  Viruses and Trojan Horses:
  1026.  -------------------------
  1027.  
  1028.  Due to the growing  concern over computer viruses,  Trojan horses, and  other
  1029.  malicious programs,  BBS  SysOps  and  ShareWare  distributors  have  started
  1030.  establishing "direct from author" libraries, or providing ONLY that  software
  1031.  which they receive  directly from the  author. We feel  this is an  excellent
  1032.  policy, and expect to see it become more common as time passes.
  1033.  
  1034.  For your information,  we post CompuShow  to CompuServe and  GEnie, and  mail
  1035.  copies directly to  a number  of BBS  SysOps and  ShareWare distributors.  We
  1036.  NEVER post directly to BBS's.
  1037.  
  1038.  (Just to  put  in  one  last "plug"),  your  concern  about  possible  "virus
  1039.  infection" is another  reason to register  the ShareWare that  you intend  to
  1040.  continue using.
  1041.  
  1042.  
  1043.  
  1044.  
  1045.   Thank you for your support:   Bob Berry
  1046.                                 Canyon State Systems and Software
  1047.                                 Post Office Box 86
  1048.                                 Sedona, Az. 86336
  1049.                                 Voice:      (602) 282-5070
  1050.                                 CompuServe: [76555,167]
  1051.                                 Internet:   76555.167@compuserve.com
  1052.                                 GEnie:      R.BERRY7
  1053.  
  1054.  
  1055.  
  1056.  
  1057.            Graphics Interchange Format(c) copyright CompuServe Inc.
  1058.              GIF(sm) is a Service Mark property of CompuServe Inc.
  1059.  
  1060.     Copyright (c) 1991, Canyon State Systems and Software (tm), Sedona, Az.
  1061.  
  1062.                                                                        Page 18
  1063.